home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / docs / mags / cd32outside5.lha / Bonus / CD32Show.lha / CD32Show.doc < prev    next >
Text File  |  2002-07-10  |  8KB  |  269 lines
  1. CD32Show - an IFF-ILBM display program for the C= CD32
  2.  
  3. Contents
  4. ========
  5.  
  6. 1. Introduction & Disclaimer
  7.  
  8. 2. Requirements
  9.  
  10. 3. How to use -> LISTFILES...
  11.  
  12. 4. How to create a slideshow CD-ROM
  13.  
  14. 5. Some hints
  15.  
  16. 6. Author
  17.  
  18. 7. Revision history
  19.  
  20. ---------------------------------------------------------------------
  21. 1. Introduction and disclaimer
  22.  
  23. Since I got my digital camera I thought about an easy way of pre-
  24. senting my holiday photos.
  25. Because of its AGA-Chipset and the CD-ROM drive, the CD32 seems to
  26. be perfect for this job, but unfortunately there was no display
  27. program that could be controlled without keyboard.
  28. So I decided to write my own display program, and the result of only
  29. two and a half days of programming is hereby proudly presented...
  30.  
  31. This program is released as freeware. The author can NOT be held
  32. responsible for any damage caused by the use of CD32Show.
  33. If used for commercial products, the author wants to obtain a cost
  34. free version of that product.
  35.  
  36. ---------------------------------------------------------------------
  37. 2. Requirements
  38.  
  39. CD32Show requires (I assume...) Amiga OS3.0 or better, and an AGA
  40. Chipset should be fine.
  41. Due to its roots by C='s ILBMLoad, iffparse.library must be present,
  42. and lowlevel.library is needed for the joypad support.
  43.  
  44. ---------------------------------------------------------------------
  45. 3. How to use
  46.  
  47. Relatively simple ;-)
  48.  
  49. When CD32Show is run, it tries to open the passed listfile. Then it
  50. starts to display the given pictures. The listfile has to contain
  51. the complete path and file name for every picture to display.
  52.  
  53. CD32Show <listfile> <args>
  54.  
  55. Args can be one or more of:
  56. -d0   for no delay
  57. -d1   for 5 sec delay
  58. -d2   for 10 sec delay
  59. -d3   for 15 sec delay
  60. -d4   for 20 sec delay
  61. -d5   for 30 sec delay
  62. -d6   for 60 sec delay
  63. -nc   to disable centering of pictures
  64. -ns   to disable scroll effect when changing pictures
  65. -l    to enable loop mode
  66. -p    to automatically start slide show
  67.  
  68. Example call:
  69. CD32Show Photos:List.asc -d1 -ns -l -p
  70.  
  71.  
  72. Example list file:
  73.  
  74. cd0:Pictures/Holiday001.iff
  75. cd0:Pictures/Holiday002.iff
  76. .
  77. .
  78. .
  79. cd0:Pictures/Christmas2001_09.iff
  80.  
  81. The pictures will be shown in exactly the order as given in the list
  82. file.
  83. However, the pictures may be arranged in more than one directory. e.g.
  84.  
  85. Holidays2002:Winter/Skiing911.iff
  86. .
  87. .
  88. .
  89. Holidays2002:SpringBreak/AnnArbor2002.iff
  90. .
  91. .
  92. .
  93. Holidays2002:Summer/Surfing409.iff
  94.  
  95.  
  96.  
  97. Slideshow conrol:
  98.  
  99. forward button      -> advance to next picture
  100. reverse button      -> go back to previous picture
  101.  
  102. play button         -> start / stop automatic slideshow (10 sec
  103.                        display time, then loading next picture)
  104.  
  105. joypad left         -> decrease color saturation
  106. joypad right        -> increase color saturation
  107. joypad up           -> lighten
  108. joypad down         -> darken
  109.  
  110. green button        -> gray mode on/off
  111. blue button         -> reset color settings to default
  112.  
  113. red button          -> QUIT CD32Show (but who wants???)
  114.  
  115. yellow button       -> Quick search menu
  116.  
  117. Quick search menu:
  118. With the pictures arranged in more than one directory, a jump to the
  119. next / previous directory can be done by pressing the joypad right /
  120. left buttons.
  121. To move forward / backward picture by picture, the forward / backward
  122. buttons can be used.
  123. The current directory is shown on top of the quick search menu screen,
  124. the current image file name below the directory.
  125.  
  126. Pressing the red button will leave the quick search menu.
  127.  
  128.  
  129. Special setup:
  130. To enter the setup screen, press & hold the red controller button.
  131. Within 2 seconds, press & hold forward, reverse and joy right
  132. buttons.
  133. This may require some training. When the blue screen appears,
  134. use the controller buttons to change settings.
  135. Green button toggles loop (restart show after last picture).
  136. Blue button changes slideshow delay time.
  137. Yellow button toggles picture centering on screen.
  138. Forward button toggles KeepView (show last picture while loading
  139. next.
  140. Reverse button toggles scrolling in and out.
  141. Setup screen can be left by pressing red button. The setup is not
  142. stored when the program is terminated.
  143.  
  144. ---------------------------------------------------------------------
  145. 4. How to create a slideshow CD-ROM
  146.  
  147. To get best display quality, I recommend rendering the pictures to
  148. PAL:High Res Laced Video-Overscan screen (picture size 724 x 566)
  149. in 8 bit (256 colors)
  150.  
  151. HAM and EHB should not be used, although those pictures can be
  152. displayed.
  153.  
  154. I suggest the following directory structure for a slideshow CD-ROM
  155.  
  156. -> s (dir)
  157.     Startup-Sequence
  158. -> c (dir)
  159.     CD32Show
  160. -> libs (dir)
  161.     lowlevel.library
  162.     iffparse.library
  163. -> Pictures (dir)
  164.     Picture01.iff
  165.     ...
  166.     PictureXX.iff
  167.  
  168. { Optional more than one picture directory, e.g.:
  169. -> PicturesTwo (dir)
  170.    Bla01.iff
  171.    ...
  172.    Bla99.iff
  173. }
  174. -> listfile.txt
  175.  
  176. Create the CD-structure in an empty subdirectory on your hard drive.
  177. Copy your pictures in the 'Pictures' subdirectory, then use the
  178. shell to create the listfile. Change your current directory to the
  179. pictures directory, and then a listfile simply can be created by the
  180. following AmigaDos command:
  181.  
  182. list >/listfile.txt lformat="MyCDRom:Pictures/%n"
  183.  
  184. where MyCDRom is the future name of the CD to be made. Then the list-
  185. file can be found in the 'root' directory.
  186. If you have more than one picture directory, change to the next
  187. directory and add the contents of that directory to the listfile by
  188.  
  189. list >>/listfile.txt lformat="MyCDRom:<directory name>/%n"
  190.  
  191. Repeat this for each picture directory you created.
  192.  
  193. If you want the pictures sorted in alphabetic order, use the cli
  194. command sort:
  195.  
  196. sort listfile.txt listfile.txt
  197.  
  198. Now create the startup-sequence. It has to contain only one line: the
  199. CD32 call.
  200.  
  201.  
  202.   CD32Show MyCDRom:listfile.txt
  203.  
  204. That's all. Read the documentation of your cd writer software on how
  205. to create autoboot-CDs for your CD32.
  206.  
  207. ---------------------------------------------------------------------
  208. 5. Some hints
  209.  
  210. CD32Show is reported to run even on a plain A500/OS2.1, if
  211. iffparse.library and lowlevel.library are found. Graphics modes to be
  212. used on non-AGA machines are PAL:High Res Laced Video Overscan
  213. (724x566) in 4 bit (16 colors; you'd better render the pictures to
  214. grayscale!) or PAL:Low Res HAM Laced Video Overscan (362x566)
  215. Other modes like EHB are supposed to work. However, the color setup
  216. functions (saturation and brightness) won't work; but using GFX modes
  217. like those, even CDTV slideshows are possible.
  218.  
  219.  
  220. Furthermore, HAM8 might be used on AGA machines, but using the color
  221. setup might lead to false coloring of the images.
  222.  
  223. ---------------------------------------------------------------------
  224. 6. Author
  225.  
  226. Send comments and lots of money (okay, forget it...) to
  227.  
  228.     Peter Habermehl
  229.     Schlippental 35
  230.  
  231.     36251 Bad Hersfeld
  232.     Germany
  233.  
  234.     eMail:   habermehl51419@waldhessen-online.net
  235.              peter.habermehl@gmx.de
  236.  
  237. ---------------------------------------------------------------------
  238. 7. Revision history
  239.  
  240. v1.8 added command line parameter configuration
  241.  
  242. v1.7 some code cleanup and internal changes. no public release
  243.  
  244. v1.6 found heavy memory loss due to multiple allocation. fixed.
  245.      some minor changes
  246.  
  247. v1.5 added quick search menu (yellow button)
  248.      scrolling somewhat faster
  249.      many internal changes
  250.  
  251. v1.2 added setup screen
  252.      to quit, red button must be pressed for at least 2 seconds
  253.      added scrolling in & out
  254.      added KeepView option
  255.  
  256. v1.1 some major improvements:
  257.       picture now centers on screen
  258.       added contrast and brightness adjustment
  259.       added autoplay mode
  260.       added black background screen while pictures been loaded
  261.  
  262. v1.0 first try
  263.  
  264. ---------------------------------------------------------------------
  265. P.S. Yep, I know there are several other ways to handle digital
  266.      photos, but
  267.  
  268.                  -> ONLY AMIGA MAKES IT POSSIBLE <-
  269.